Exporting Movie Data11

Since QuickTime 1.6.1, the sound movie export component has been updated to take advantage of Sound Manager 3.0. Previously, only the first sound track in the movie was exported. Now sound tracks are mixed together before they are exported. If you want to use sound mixing, you can use the PutMovieIntoTypedHandle function to take advantage of the export component. Furthermore, you can now specify the format of the exported sound, so you can convert 16-bit sound to 8-bit sound or reduce stereo to mono. See Inside Macintosh: QuickTime for a description of the PutMovieIntoTypedHandle function.

MovieExportGetAuxillaryData

QuickTime 1.6.1 added a new result code to this function. A movie export component returns the following result code when MovieExportGetAuxillaryData is called requesting a type of auxiliary data that the component cannot generate.

RESULT CODES



 

auxillaryExportDataUnavailable

-2058

Cannot generate the requested type of auxiliary data.

MovieExportSetSampleDescription

The MovieExportSetSampleDescription function allows your application to request the format of the exported data. This function is supported by the sound movie export component, for example.



 
pascal ComponentResult MovieExportSetSampleDescription(

                     MovieExportComponent ci,

                     SampleDescriptionHandle desc,

                     OSType mediaType)

ci: Specifies the movie component for the request. Applications obtain this reference from the Component Manager's OpenComponent function.
desc: Contains a handle to a valid QuickTime sample description.
mediaType: Indicates the type of media the sample description is for. For example, if the sample description was a sound description, this parameter would be set to SoundMediaType .

DISCUSSION

A movie export component may use all, some, or none of the settings from the sample description.

RESULT Codes

`badComponentInstance`	0x80008001	Invalid movie import component instance
`badComponentSelector`	0x80008002	Function not supported

MovieExportValidate

The MovieExportValidate function allows your application to determine whether a movie export component can export all the data for a specified movie or track.



 
pascal ComponentResult MovieExportValidate(

                     MovieImportComponent ci,

                     Movie theMovie,

                     Track onlyThisTrack,

                     Boolean *valid)

ci: Specifies the movie import component for the request. Applications obtain this reference from the Component Manager's OpenComponent function.
theMovie: Specifies the movie to validate.
onlyThisTrack: Specifies a track within the movie to validate, or nil if the entire movie is to be validated.
valid: A pointer to a Boolean value. If the data for the movie or track can be exported by the component, the value is true .

DISCUSSION

MovieExportValidate allows an application to determine if a particular movie or track could be exported by the specified movie data export component. The movie or track is passed in the theMovie and onlyThisTrack parameters as they are passed to MovieExportToFile .

Although a movie export component can export one or more media types, it may not be able to export all the kinds of data stored in those media. The MovieExportValidate function allows applications to get this additional information.

Movie data export components that implement this function also set the canMovieExportValidateMovieflag in their component flags.

RESULT Codes

`badComponentInstance`	0x80008001	Invalid movie import component instance
`badComponentSelector`	0x80008002	Function not supported